home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / misc / hamware / cwterm.doc < prev    next >
Text File  |  1994-11-04  |  70KB  |  1,484 lines

  1.                                    Chapter 1
  2.  
  3.                                   Introduction
  4.  
  5.      1.1  What is CWTERM?
  6.  
  7.      CWTERM is a complete CW operating environment.  It consists of a set
  8.      of programs that provide the amateur radio operator with automated ter-
  9.      minal node control, logging, and message generation.  CWTERM.EXE, the
  10.      primary TNC program, is a 'C' program which provides the user with a menu
  11.      oriented interface to the CWTERM.  It also has links to the other programs
  12.      which provide the operator with a full set of data base functions.
  13.  
  14.           . TNCED.EXE    -  full screen editor
  15.  
  16.           . LOGBOOK.EXE  -  Index Sequential Access Method (ISAM) based data
  17.                             base program
  18.  
  19.           . COUNTRIES.EXE - callsign/country lookup program with great circle
  20.                             distance & bearing computation
  21.  
  22.           . HAMGRAM.EXE   - NTS message generation and database
  23.  
  24.      1.2 Flexibility
  25.  
  26.        -  CWTERM may be configured to provide CW input/output to either of
  27.           ports COM1, COM2, LPT1 or LPT2
  28.  
  29.        -  Fully configurable color selection and file location are just a
  30.           few of the adjustable parameters.
  31.  
  32.        -  Provides all of the common file handling functions of the popular
  33.           communications programs including ASCII file transmit and re-
  34.           ceive, and screen buffer captures,
  35.  
  36.        -  Supports both CW and MCW modes.
  37.  
  38.        -  Allows the transmission of FARNSWORTH type code formation.
  39.  
  40.        -  Useable for automatic transmission of code practice sessions using
  41.           automatic file transmission with imbedded command strings.
  42.  
  43.      1.3 Ease of Use
  44.  
  45.        -  Pull down menus provide complete access to all internal and
  46.           external functions.
  47.  
  48.        -  Fully scrollable receive buffer of 800 lines.  Receive buffer
  49.           may be written to disk file of users choice.
  50.  
  51.        -  Receive function operates independent of transmit buffer.  Create
  52.           outgoing text while the other op' is transmitting.
  53.  
  54.      1.4 Distribution of CWTERM
  55.  
  56.      CWTERM is FreeWare Software.  David Freese, W1HKJ, and Clermont Computer 
  57.      Consultants retains sole distibution and resale rights to all programs 
  58.      contained on the distribution disk including:
  59.  
  60.               CWTERM.EXE
  61.               TNCED.EXE
  62.               TNCEDINS.EXE
  63.               LOGBOOK.EXE
  64.               MAKEDBF.EXE
  65.               HAMGRAM.EXE
  66.               COUNTRY.EXE.
  67.               PORTTEST.EXE
  68.               PARSE.EXE
  69.  
  70.      1.5  The most recent version of this software is always available from
  71.      the author at:
  72.  
  73.                David Freese, W1HKJ
  74.                122 N. Ravenwood Drive
  75.                Cape May Court House, NJ  08210
  76.                (609) 624 0076.
  77.  
  78.           The cost for the software on 3 1/2" diskette is $10.00.
  79.      Please send check or money order drawn on U.S. dollars with your order.
  80.  
  81.      1.6  Disclaimer
  82.  
  83.      W1HKJ, David Freese and Clermont Computer Consultants make no  warran-
  84.      ty, expressed or implied, concerning this program's merchantability or
  85.      fitness for any particular use.  In no event is David Freese or  Cler-
  86.      mont Computer Consultants liable to you for any damages resulting from
  87.      your use of the program.
  88.                                    Chapter 2
  89.  
  90.                           Getting Started with CWTERM
  91.  
  92.      2.1 System Requirements
  93.  
  94.      CWTERM has the following minimal requirements:
  95.  
  96.        -  IBM  PC, XT, AT, PS-2 or compatible with at least 320 K bytes  of
  97.           memory.
  98.  
  99.        -  DOS 2.0 or later, or any version of OS2
  100.  
  101.        -  Floppy disk drive, 360K, 1.2M, 720K, 1.44M, or a hard drive.
  102.  
  103.        -  Either COM1, COM2, LPT1 or LPT2 available for CW interface.
  104.  
  105.      2.2 CWTERM installation
  106.  
  107.      CWTERM is distributed with the following files:
  108.  
  109.           CWTERM.EXE     Executable file which interfaces to the
  110.                          selected port.
  111.  
  112.           CWTERM.CFG     Sample configuration file
  113.  
  114.           PORTTEST.EXE   I/O port test program.  Helps to determine
  115.                          access to keyline, ptt-line, and receive data
  116.                          input pins.
  117.  
  118.           PARSE.EXE      Text parsing program used to create code
  119.                          practice sessions from ordinary ASCII text files.
  120.  
  121.           SAMPLE.QST     Sample practice session produced by PARSE.EXE.
  122.  
  123.           SCRIPT.FST     Sample script file for use with PARSE.EXE.
  124.  
  125.           PRACTICE.EXE   Program to automatically invoke CWTERM with
  126.                          a date stamped source file.
  127.  
  128.           COUNTRY.EXE    Stand alone prefix/country lookup program
  129.  
  130.           COUNTRY.LST    ASCII text file containing the Prefix/Country list
  131.                          as found in the 1991 Call Book.  This file is used
  132.                          by COUNTRY.EXE.
  133.  
  134.           TNCED.EXE      Full screen editor, colors and keyboard reconfig-
  135.                          urable.  Edits file up to maximum of available
  136.                          computer memory.
  137.  
  138.           TNCEDINS.EXE   Installation program for TNCED.EXE.  Allows color,
  139.                          and keyboard reconfiguration.
  140.  
  141.           LOGBOOK.EXE    ISAM based database for keeping amateur radio log.
  142.  
  143.           MAKEDBF.EXE    ISAM to DBASE-III conversion program.
  144.  
  145.           HAMGRAM.EXE    dBase-III compatible database of National Traffic
  146.                          System messages.  Builds NTS messages with proper
  147.                          pre and postambles, and word count.
  148.  
  149.      2.3  First-time Setup of CWTERM
  150.  
  151.      HARD DISK   I suggest you create a directory called \HAM.  Copy all of
  152.      the files to this directory and include the directory name in your
  153.      path definition.
  154.  
  155.      FLOPPY DISK Simply make a working copy of the distribution disk to use
  156.      as a working disk.  If you have a two floppy drive system you may
  157.      modify the configuration file to direct all log and other data files
  158.      to the second disk.  See the configuration file specification below.
  159.  
  160.      2.3.1 CONFIG.SYS - no changes to your config.sys file are necessary.
  161.  
  162.      2.3.2 AUTOEXEC.BAT - Add the directory name of your CWTERM files to
  163.      your path statement.
  164.  
  165.      2.3.3  Before  executing the program, you should prepare the CWTERM.CFG
  166.      file for your specific installation.  The TNCED editor may be used to
  167.      modify the included sample configuration file.
  168.  
  169.      2.3.4  The CWTERM.CFG file contains the following configurable items.
  170.  
  171.      Type of CPU:
  172.  
  173.           CPU=SLOW                 change to MEDIUM or FAST as the CPU
  174.                                    allows.
  175.  
  176.      Code Generation defaults:
  177.  
  178.           WPM=20                   code speed, words per minute
  179.           FARNSWORTH=0             Farnsworth code speed, 0 = disable
  180.           WEIGHT=3.0               dash/dot ratio
  181.  
  182.      Transmitter Control / Receiver Data Port Specification:
  183.  
  184.           PORT=0                   0=LPT1, 1=LPT2, 2=COM1, 3=COM2
  185.                                 ┌─ Active state of control lines
  186.           KEYOUT=0              ├─>0 = 0/-12 v, 1 = +5/+12 v
  187.           RCVINP=0              ├─>"
  188.           PTTOUT=0              └─>"
  189.           XMTCOMP=0                Key line compensation in milliseconds
  190.  
  191.      Mode specifiers:
  192.  
  193.           MCW=0                    PTT output for VHF xmtrs; 0=OFF, 1=ON
  194.           PTTDELON=0.10            Time between PTT and Keyline closure
  195.           PTTDELOFF=1.00           Time between last char & PTT open
  196.           DUPLEX=HALF              or FULL, Simultaneous Xmt/Rcv
  197.  
  198.      Miscellaneous Parameters:
  199.  
  200.           TONES=1                  Computer Speaker monitor; 0=OFF, 1=ON
  201.           FREQ=800                 Monitor frequency
  202.  
  203.           BUFFERFILE=CWTERM.BFR    Default buffer file - loaded at startup
  204.  
  205.      Child process definitions:
  206.  
  207.           LOGPROG=LOGBOOK.EXE      NOTE: child process may be specified
  208.           LOGBOOK=LOGBOOK                as:  d:\path\program_name
  209.           COUNTRIES=COUNTRY.EXE
  210.           COUNTRYLIST=COUNTRY.LST
  211.           NTSPROG=HAMGRAM.EXE
  212.           EDITOR=TNCED.EXE
  213.  
  214.      Color definitions: (suitable for monochrome monitor)
  215.  
  216.           STATUS_FG=BLACK
  217.           STATUS_BG=WHITE
  218.           RCV_FG=WHITE
  219.           RCV_BG=BLACK
  220.           XMT_FG=WHITE
  221.           XMT_BG=BLACK
  222.           VIEW_FG=BLACK
  223.           VIEW_BG=LIGHTGREY
  224.           MENU_FG=BLACK
  225.           MENU_BG=LIGHTGREY
  226.           POP_FG=LIGHTGREY
  227.           POP_BG=BLACK
  228.           POP_HI=WHITE
  229.           ERROR_FG=BLACK
  230.           ERROR_BG=LIGHTGREY
  231.           NOTICE_FG=BLACK
  232.           NOTICE_BG=LIGHTGREY
  233.           MESSAGE_FG=BLACK
  234.           MESSAGE_BG=LIGHTGREY
  235.  
  236.      If you have a logbook program that you prefer to use, it may be specified
  237.      on the LOGPROG= line.  If that program expects to be passed a parameter
  238.      it may be specified on the LOGBOOK= line.  If no drive or path is given
  239.      then CWTERM will expect to find them in the default directory.
  240.  
  241.      If the CWTERM.CFG file is deleted the program will use the default
  242.      configuration values shown above.  SAVING the configuration values will
  243.      generate a properly formated CWTERM.CFG file which may then be edited.
  244.  
  245.      2.4 Executing CWTERM.
  246.  
  247.      The following sequence is recommended when using CWTERM and the CWTERM
  248.      interface:
  249.  
  250.           1.  Turn computer on.
  251.           2.  Turn interface on.
  252.           3.  Turn transmitter/receiver on.
  253.           4.  Change to drive and directory containing CWTERM programs and
  254.               execute CWTERM.EXE.
  255.  
  256.           Reverse this process when securing your station.
  257.  
  258.      2.5 Time of Day Clock
  259.  
  260.      CWTERM displays the time of day in hours-minutes-seconds format corrected
  261.      to GMT if the environment variable TIMEZONE is set.  The program reads
  262.      the TIMEZONE environment variable, and the DOS time-of-day ONLY ON
  263.      PROGRAM STARTUP.  Thereafter, the time of day display is internally
  264.      updated in CWTERM and no further reference is made to the DOS clock.
  265.      This is necessary to avoid conflicts with the BIOS-ROM code.
  266.  
  267.      2.5.1 TIME ZONE Environment Variable
  268.  
  269.      Enter the following either in your AUTOEXEC.BAT file or from the DOS
  270.      command prompt:
  271.  
  272.            SET TIMEZONE=4      ( a range of -11 to +11 allowed)
  273.  
  274.      If the TIMEZONE variable is missing from the environment or its value is
  275.      0 then no correction is made to GMT.
  276.  
  277.  
  278.                                    Chapter 3
  279.  
  280.                          Main Display & Operating Modes
  281.  
  282.      3.1  Main Display
  283.  
  284.      3.1.1   The  main  display consists of a menu bar, a transmit  window,
  285.      a  receive window and a status bar.
  286.  
  287.           ┌──────────────────────────────────────────────────────────┐
  288.           │                        Menu Bar                          │
  289.           ├──────────────────────────────────────────────────────────┤
  290.           │                                                          │
  291.           │                                                          │
  292.           │                                                          │
  293.           │                     Receive window                       │
  294.           │                                                          │
  295.           │                                                          │
  296.           │                                                          │
  297.           │                                                          │
  298.           ├──────────────────────────────────────────────────────────┤
  299.           │                        Status Bar                        │
  300.           ├──────────────────────────────────────────────────────────┤
  301.           │                                                          │
  302.           │                                                          │
  303.           │                     Transmit Window                      │
  304.           │                                                          │
  305.           │                                                          │
  306.           └──────────────────────────────────────────────────────────┘
  307.  
  308.      3.1.2   Receive Window - This multi-line window will contain the  most
  309.      recently  received characters.  Incoming text is also stored in an 800
  310.      line text buffer.
  311.  
  312.      3.1.3   Status Bar - The right hand portion of the status bar shows the
  313.      present date time properly converted to Greenwich Mean Time.  The
  314.      left hand portion of the status bar shows the receive WPM rate, the
  315.      transmit WPM rate, whether MCW mode is active,  whether the capture or
  316.      receive file is open, and if a text file is being transmitted.
  317.  
  318.      3.1.4  Transmit Window - The transmit window is a multi-line  scrolla-
  319.      ble  area for entering transmitted text.  When transmit data is  taken
  320.      from  external files it is  shown sequentially in the area.
  321.  
  322.      3.1.5  Pull Down Menus -  All program operations are available through
  323.      a pull down menu system.  The menu system is activated by pressing the
  324.      F10 key or the ALT-key selection.  Menu selection is accomplished by
  325.      use of the arrow and Enter keys.  Some menu selections will open submenus
  326.      or dialog boxes for data entry.
  327.  
  328.      3.2  Operating Modes
  329.  
  330.      3.2.1  Transmitter Tune - select this function by highlighting it and
  331.      pressing ENTER.  The keyline output will become active and will remain
  332.      so until any keyboard key is pressed.
  333.  
  334.      3.2.2  Send Dits - select this function by highlighting and pressing
  335.      ENTER.  The program will send a continuous stream of 'E's to the trans-
  336.      mitter.  This can be useful when measuring the keying characteristics
  337.      of your transmitter.  Press ESC to return to the menu.
  338.  
  339.      3.2.3  Modulated CW  -  CWTERM  provides the capability of transmiting
  340.      using MCW with the proper interface.  Both a PTT line and a CW keyline
  341.      are activated in sequential order.  This allows the use of the program
  342.      with a VHF or UHF transmitter using MCW transmissions, or with an older
  343.      CW transmitter requiring separate transmit enable.
  344.  
  345.           NOTE: in the MCW mode a delay will occur between the PTT line
  346.                 activation and the sending of CW via the KEY line output.
  347.                 If you experience a delay between typing and initial xmtr
  348.                 keying check to see whether the MCW mode is ON or OFF.
  349.  
  350.      The MCW operation is shown on the status bar as a MCW just to the right
  351.      of the transmit WPM indicator.
  352.  
  353.      It is necessary to set the push-to-talk-ON and push-to-talk-OFF delays.
  354.      These are also found on the 'Modes' menu.  The ON delay specifies the
  355.      length of time between activating the PTT line and the transmission of
  356.      the first CW character.  The OFF delay specifies the length of time
  357.      between keyboard inactivity and release of the PTT line.
  358.  
  359.      3.1.4 Half / Full Duplex - CWTERM is capable of simultaneous transmit
  360.      and receive.  This mode only makes sense when the station is equiped
  361.      with a separate transmitter and receiver.  In HALF DUPLEX mode the 
  362.      detection of received characters is disabled when transmitting.  In 
  363.      FULL DUPLEX mode the receive function remains enabled and you may see 
  364.      full or partial detection of your own transmission depending on your 
  365.      transceiver performance.
  366.  
  367.      3.1.5 Receive Case selection - The program may be configured to display
  368.      the received text in all UPPER or all lower case.  This selection is
  369.      found on the MODES pull down menu.
  370.  
  371.      3.1.6 Transmit/Receive speed lock - The transmit and receive WPM settings
  372.      may be operated independently or in lock-step.  If the speeds are locked
  373.      and the transmit WPM is changed, the receive WPM will be re-initialized
  374.      to the transmit rate.  If the speeds are independent, one may be changed
  375.      without affecting the other.
  376.  
  377.      3.3  Automatic File Execution
  378.  
  379.      The program can load a text file for automatic transmission.  To do this
  380.      invoke the program as:
  381.  
  382.           CWTERM filename,  where filename specifies the text file.
  383.  
  384.      The textfile can contain imbedded commands which can be used to alter the
  385.      characteristics of CWTERM.  The commands should be placed on separate lines
  386.      within the text.  The recognized commands are:
  387.  
  388.           |Wnn   change WPM to nn
  389.  
  390.           |Fnn   change Farsnworth WPM to nn
  391.  
  392.           |Dnn   delay transmission nn seconds
  393.  
  394.           |Q     exit back to operating system.
  395.  
  396.      The sample file, SAMPLE.QST, demonstrates the use of these commands to
  397.      produce an automated transmission of a code practice session.  The author
  398.      uses the OS2 operating system which allows the specification of timed
  399.      program execution events.
  400.  
  401.      During automatic operation all transmitted characters are displayed in
  402.      the transmit buffer area.  The control code sequences are NOT displayed.
  403.  
  404.      The automatic transmission capability can be extended by using
  405.      PRACTICE.EXE.  This program searches the active drive/directory for a
  406.      file with the name  MM-DD-YY.QST, for example: 09-21-91.QST.  It then
  407.      invokes the CWTERM program for automatic operation with this source file
  408.      specified.  By producing a series of '.QST' files with a timed execution
  409.      of PRACTICE, you can provide automated, timed, code practice sessions in
  410.      your area.  Cape May County enjoys this service on 147.585 MHz.  Any
  411.      person with a scanner can copy the code practice sessions.
  412.  
  413.  
  414.      3.4  CONTROL P and CONTROL X control keys
  415.  
  416.      CONTROL P (ctl P) will temporarily halt the transmission of outgoing
  417.      text.  This acts as a toggle.  The status bar ON will change to OFF.
  418.      You may continue to enter text into the transmit buffer.  This allows
  419.      QSK operation from the keyboard.  You can use the CONTROL P toggle to
  420.      disable outgoing text during reception.  This will allow you to prepare
  421.      a response during the incoming message.  Toggling CONTROL P will begin
  422.      the transmission of the text in the transmit buffer.
  423.  
  424.      CONTROL X (ctl X) will immediately halt the transmission of outgoing
  425.      text.  It will be necessary to re-enter any text not sent from the
  426.      transmit buffer.  This is not a toggle.  If you begin entering text
  427.      and the CONTROL P function shows ON the transmitter will immediately
  428.      begin keying.
  429.  
  430.      3.5  Received CW Auto Tracking
  431.  
  432.      The program is capable of automatically tracking the incoming CW wpm
  433.      rate.  This is implemented using the digital equivalent of a low pass
  434.      filter.  The wpm rate is derived from the signal timing of dots and
  435.      dashes.  The performance of the wpm filter is dependent on the quality
  436.      of the detected CW.  The received CW detection algorithims provide
  437.      some protection against burst noise, but under very noisy conditions
  438.      the wpm rate will become unstable.  The CW Auto Tracking function can
  439.      be toggled ON and OFF using the 'ALT A' key combination.  When the
  440.      program is in the autotrack mode the status bar will indicate
  441.  
  442.           AR
  443.  
  444.      on the left side.  The AR indicates auto-track-receive and is followed
  445.      by the detected WPM rate.  When autotrack is toggled OFF the 'A' is
  446.      replaced with a graphics line character and the WPM is locked to the
  447.      transmit WPM rate.
  448.  
  449.      If you find that you prefer leaving the program in the autotrack mode
  450.      and the detected wpm becomes unstable you can reset the filters by
  451.      pressing ALT_A twice.  This will reset the filter to the transmit WPM
  452.      and then restart the tracking filter.
  453.  
  454.      Under normal QSO conditions (ie: fixed WPM rates) you will obtain best
  455.      performance by disabling the autotracking filter.
  456.  
  457.      3.6  FAST CHANGES IN WPM SPEEDS
  458.  
  459.      The function keys F5 and F6 decrease or increase the receive WPM rate by
  460.      1 respectively for each keypress.  Holding either down will cause the
  461.      smooth transition from the present to a new WPM rate.
  462.  
  463.      The function keys F7 and F8 decrease or increase the transmit WPM rate by
  464.      1 respectively for each keypress.  Holding either down will cause the
  465.      smooth transition from the present to a new WPM rate.  If the transmit
  466.      and receive WPM rates are set for LOCKED operation both the transmit
  467.      and receive WPM will be forced to same value for each keypress.  Pressing
  468.      F7 F8 (or reverse) in sequence therefore has the same effect on the
  469.      tracking filter as pressing ALT_A twice.
  470.                                    Chapter 4
  471.  
  472.                                   Menu System
  473.  
  474.      4.1  A pull-down / pop-up menu system is used to access all function
  475.      of the program.  In addition, certain functions can be quickly brought
  476.      up by alternate hot keys.  On the menu system these are shown by the
  477.      <K> symbol where K is the access character.
  478.  
  479.      4.2  The menu system is activated by pressing function key <F10> or
  480.      the alt-F, alt-B, alt-G, alt-P, alt-M, alt-D key combination.
  481.      The top line of the display contains the names of each menu section
  482.      and the leftmost menu will be active.
  483.  
  484.      4.3  You can move between vertical menu items by pressing the bold
  485.      character or by using the up and down arrow keys.  Movement between
  486.      horizontal menus is obtained by use of the left and right arrow keys
  487.      only.  The selected item is indicated by reverse field.  Press
  488.      <ENTER> to activate that function.
  489.  
  490.      4.4  For example, to enable the capture buffer press <C> and then <ENTER>.
  491.      You could also have directly enabled the capture buffer by ALT-C key com-
  492.      bination.  Hot keys of this type are shown by the <key> symbol to the
  493.      right of the menu item.
  494.  
  495.      4.5  The menus are:
  496.  
  497.      Files  Buffers  loG/NTS  Parameters  Modes  DosApps
  498.      ┌────────────┐
  499.      │Capture <C> │
  500.      │Receive <R> │
  501.      │Transmit    │
  502.      └────────────┘
  503.  
  504.      Files  Buffers  loG/NTS  Parameters  Modes  DosApps
  505.             ┌────────────┐
  506.             │clrRcvWindow│
  507.             │clrXmtWindow│
  508.             │clearBoth   │
  509.             │────────────│
  510.             │Eras RcvBuff│
  511.             │Save RcvBuff│
  512.             │View RcvBuff│
  513.             │────────────│
  514.             │Load XmtBuff│
  515.             │Mod  XmtBuff│
  516.             │Trsmt Buffer│
  517.             └────────────┘
  518.  
  519.      Files  Buffers  Log/NTS  cOlors  Parameters  Modes  DosApps
  520.                      ┌───────────┐
  521.                      │Country    │
  522.                      │Logbook <L>│
  523.                      │NTSmsgs    │
  524.                      └───────────┘
  525.      Files  Buffers  Log/NTS  Parameters  Modes  DosApps
  526.                               ┌────────────┐
  527.                               │Wpm      <W>│
  528.                               │wEight      │
  529.                               │cOmp(msec)  │
  530.                               │Farsnworth  │
  531.                               │────────────│
  532.                               │Colors      │
  533.                               │────────────│
  534.                               │Tone on/off │
  535.                               │tone fReq   │
  536.                               │────────────│
  537.                               │t/r Port    │
  538.                               │────────────│
  539.                               │Load kbd map│
  540.                               │sAve kbd map│
  541.                               │────────────│
  542.                               │Save params │
  543.                               │View params │
  544.                               └────────────┘
  545.  
  546.      Files  Buffers  Log/NTS  Parameters  Modes  DosApps
  547.                                           ┌───────────────┐
  548.                                           │Xmtr Tune      │
  549.                                           │───────────────│
  550.                                           │Send Dits      │
  551.                                           │───────────────│
  552.                                           │ptt Enable     │
  553.                                           │ptt On  delay  │
  554.                                           │ptt oFF delay  │
  555.                                           │───────────────│
  556.                                           │Full/Half Duplx│
  557.                                           │Rcv Case Set   │
  558.                                           │xmt/rcv Track  │
  559.                                           └───────────────┘
  560.  
  561.      Files  Buffers  Log/NTS  Parameters  Modes  DosApps
  562.                                                  ┌─────────┐
  563.                                                  │Dos      │
  564.                                                  │Editor   │
  565.                                                  │eXit  <X>│
  566.                                                  └─────────┘
  567.  
  568.      4.6 ALTERNATE and CONTROL Keys
  569.  
  570.      The following Alternate and Control Key combinations will invoke the
  571.      specified action:
  572.  
  573.           alt 0  -  Transmit the buffer specifed by the designated number
  574.             .       key,
  575.             .
  576.             .
  577.           alt 9
  578.  
  579.           alt A  -  Toggle Receive Auto Track filter
  580.  
  581.           alt B  -  Activate the BUFFERS pull down menu,
  582.  
  583.           alt C  -  Open (or close, a toggle) the log file, CWTERM.TXT,
  584.  
  585.           alt D  -  Activate the DOSAPPS pull down menu,
  586.  
  587.           alt F  -  Activate the FILES pull down menu,
  588.  
  589.           alt G  -  Activate the logG/NTS pull down menu,
  590.  
  591.           alt L  -  Invoke the child process LOGBOOK, LOGBOOK.EXE (or the one
  592.                     specified in the configuration file, CWTERM.CFG),
  593.  
  594.           alt M  -  Activate the MODES pull down menu,
  595.  
  596.           alt P  -  Activate the PARAMETERS pull down menu,
  597.  
  598.           alt R  -  Open a user specified receive data file, or close the
  599.                     file if previously opened,
  600.  
  601.           alt W  -  Open a prompt box for a new WPM entry,
  602.  
  603.           alt X  -  End the CWTERM session.
  604.  
  605.           ctl P  -  Pause toggle, for transmitter keying.  Useful for QSK
  606.                     operation,
  607.  
  608.           ctl X  -  Dump the transmit type-ahead buffer.
  609.  
  610.           F7     -  Decrease Transmit & Receive WPM by 1
  611.  
  612.           F8     -  Increase Transmit & Receive WPM by 1
  613.  
  614.           PGUP   -  Open the Receive Buffer View Window
  615.  
  616.      4.7 SPECIAL KEYS
  617.  
  618.      The following keys are used both for transmission and display of the
  619.      designated special CW character:
  620.  
  621.              ASCII CHAR   CW Equivalent
  622.  
  623.                >                AR    . _ . _ .
  624.  
  625.                <                AS    . _ . . .
  626.  
  627.                $ or =           SK    . . . _ . _
  628.  
  629.                [                KN    _ . _ _ .
  630.  
  631.                - (hyphen)       BT    _ . . . _
  632.  
  633.                _ (underscore)   THT   _ . . . . _
  634.  
  635.                !                AAA   . _ . _ . _
  636.                                    Chapter 5
  637.  
  638.                                 Transmit Buffers
  639.  
  640.      5.1   Ten transmit buffers are available for quick insertion into  the
  641.      transmit data stream.  These buffers are read from and written  to the
  642.      file CWTERM.BFR unless otherwise specified.  Transmit buffer mainten-
  643.      ance is found under the Buffer pull down menu.
  644.  
  645.      5.2   Transmitting  a buffer - You may select a transmit buffer by one
  646.      of two methods.
  647.  
  648.           (1) Using the pull down menus, select "Tnsmt Buffer".  The entire set
  649.               of 10 buffers will be displayed.  Using the UP and DWN arrow
  650.               keys, select the desired buffer and press ENTER.  If you change
  651.               your mind you may abort the selection by pressing ESC.
  652.  
  653.           (2) Select a transmit buffer by  using  the alternate key combined
  654.               with a number key.  For example: buffer  number 3 is inserted
  655.               into the transmit stream by pressing alt<3>.
  656.  
  657.      5.3  Viewing and Modifying Buffers - Access the buffers by selecting
  658.      ModBuffer on the Buffer pull down menu.  Specify the name of the buffer
  659.      file.  The default editor will be called with the specified file.  Change
  660.      the text as desired and exit the editor using <alt>X (if using TNCED).
  661.      The ten buffers will be updated on return to TNC.
  662.  
  663.      5.4 Loading a new set of buffers.  Select the LoadBuffer function on the
  664.      Buffer pull down menu.  Specify the name of the desired buffer file.  If
  665.      the file is found the ten buffers will be overwritten with the file data.
  666.      The buffer view window is immediately opened if the load has been
  667.      successful.  Select a buffer for transmission as specified above.
  668.  
  669.      5.5  Modifying the buffer file directly - Each buffer file is a simple
  670.      text  file  containing ten lines where each line does  not  exceed  80
  671.      characters.   You may modify the file using a text editor.  Make  sure
  672.      that the editor treats the file as a non-document.
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.      NOTE:  FILE SELECTION
  681.  
  682.      At any file name prompt you may enter a sequence of wildcards in the
  683.      file name.  For example:
  684.  
  685.           *.TXT       ..\TEXT\BUFFERS.?91      c:\WP\BUFFER?.WP
  686.  
  687.      When a wildcard is entered a pick list will be displayed showing all
  688.      matching file names.  The actual list may be longer than the display
  689.      so you can scroll past the end of the display.  Move to the desired
  690.      file using the UP and DOWN arrow keys and select it by pressing <ENTER>.
  691.      If the file is not found, press <ESC> to return to the file name
  692.      prompt.  If only one matching file is found, its name will be entered
  693.      into the file name prompt and no pick list will be displayed.
  694.                                    Chapter 6
  695.  
  696.                                File Transmission
  697.  
  698.      6.1  Plaintext (ASCII) files can be transmitted in any mode.  This
  699.      function is found on the Files menu.  You will be prompted to enter the
  700.      name      of the file for transmission.  Include the drive and path if
  701.      necessary.  Characters will begin transmission immediately and are
  702.      displayed in the transmit window.  Tranmsission can be terminated by
  703.      pressing <ESC>.
  704.                                    Chapter 7
  705.  
  706.                                  Receive Buffer
  707.  
  708.      7.1  The receive buffer in CWTERM consists of 800 lines of 80 characters
  709.      each.  The receive window only shows the last several lines  in the
  710.      buffer.  Access to the entire receive buffer can be made by pressing
  711.      the Page-Up key or via the Files pull down menu.  The receive window
  712.      will  then  show the  receive  buffer beginning with the first line of
  713.      text  received.  Movement  through the buffer is made with the up and
  714.      down arrow  keys.  When   you  are  finished  press  <ESC>  to  return
  715.      to the normal transmit/receive screen.
  716.  
  717.      7.2  Saving the Receive Buffer - Access the save receive buffer function
  718.      on the Buffers pull down menu.  You will be prompted for a filename in
  719.      which to save the buffer.  The default is CWTERM.BFR.
  720.                                    Chapter 8
  721.  
  722.                                  Data Base Use
  723.  
  724.      8.1  CWTERM uses and maintains three distinct data base files:
  725.  
  726.           DEFAULT NAME             USE
  727.  
  728.           LOGBOOK.DB     ISAM database file provides full log  keep-
  729.                          ing functions using a pop up menu.
  730.  
  731.           HAMGRAM.DBF    DBASE-III  compatible file containing  a  complete
  732.                          message generation and storage system.
  733.  
  734.           COUNTRY.LST    ASCII text file containing cross reference data of
  735.                          Prefix  to  Country.  Much faster than  using  the
  736.                          callsign book.
  737.  
  738.      8.2  LOG BOOK DATA FILE
  739.  
  740.      LOGBOOK.DBF  is the default log book file.  You may alter the log  name
  741.      in the CWTERM.CFG configuration file.  This file is an ISAM database with
  742.      the following field definitions:
  743.  
  744.           FIELD NAME     TYPE      SIZE
  745.           DATE           DATE      8
  746.           TIME           CHAR      4
  747.           CALLSIGN       CHAR      15
  748.           RSTIN          CHAR      3
  749.           RSTOUT         CHAR      3
  750.           FREQ           NUMBER    8:4
  751.           MODE           CHAR      3
  752.           COMMENT        CHAR      29
  753.           QSLSENT        DATE      8
  754.           QSLRCVD        DATE      8
  755.  
  756.          The program MAKEDBF.EXE can be used to convert the ISAM database to
  757.      a DBASE-III compatible form if your want to access the data for adhoc
  758.      queries.
  759.  
  760.      8.2.1   LOGBOOK INDEX FILES - A single composite index file is maintain-
  761.      ed.  Both a DATE-TIME and CALLSIGN index are contained in this single
  762.      IDX file.
  763.  
  764.      8.2.2   Accessing the Logbook Data  -  The logging function is accessed
  765.      on the Log/NTS pull down menu or by pressing <alt>L. The following form
  766.      will overwrite the lowest lines of the screen.
  767.  
  768.   Date  │Time│  Callsign     │IN │OUT│ Freq   │MOD│ Comments       │RecNbr
  769. ────────┼────┼───────────────┼───┼───┼────────┼───┼────────────────┴────────────
  770.         │    │               │   │   │        │   │
  771. ────────┴────┴───────────────┴───┴───┴────────┴───┴─────────────────────────────
  772.     Add Bottom Delete Edit Find Index Next QSL Prev Top  eXit       [DATETIME]
  773.  
  774.      8.2.3  A new database will always show a RecNbr of 0 and blank fields
  775.      with the exception of Freq which will be 0.0000. Each function is invoked
  776.      by the first capital letter in the command word.  To record a logbook
  777.      entry use the Add function.  To modify an existing entry use the Edit
  778.      function.  When done either Adding or Modifying an entry return to the
  779.      command mode by pressing ESC to discard the changes or ctl_END to save
  780.      them to the database.  For additions to the database the Date and Time
  781.      will be entered from the system date-time corrected to GMT in accordance
  782.      with the environment variable TIMEZONE.
  783.  
  784.           IMPORTANT!!  ESC     discards the ADD or EDIT record
  785.                        ctl_END saves the record to the database.
  786.  
  787.      8.2.4  Pressing <I> for index will toggle the index between callsign
  788.      and date-time.  The date-time is the default index and the last entry
  789.      in the log book will be the one shown on initial entry.
  790.  
  791.      8.2.5  The <F>ind function performs the search based on the callsign
  792.      index.  I usually use this to find a previously worked callsign.
  793.      My log now has over 2000 entries covering a period of three years.
  794.      Finding a previously worked station is instantaneous!  The find may
  795.      be for an entire callsign or a partial.  For example:  entering W4
  796.      for the search string will put you at the first W4 callsign in the
  797.      logbook.  If a W4xxx entry does not exist, then the next record in order
  798.      after W4 will be displayed.
  799.  
  800.      8.2.6  <D>elete a record opens a dialog box for confirmation of the
  801.      delete request.  A delete record in an ISAM database is permanent!
  802.      The database and both index files will be modified to reflect the 
  803.      removal of all 'deleted' records.
  804.  
  805.      8.2.7  Return to the calling program (TNC or COMMAND.COM) BY pressing
  806.      X for eXit.
  807.  
  808.      8.2.8  Separate LOGBOOK maintenance.  The program LOGBOOK.EXE can be
  809.      executed from the DOS command line.  Multiple logbooks can be maintained
  810.      and are accessed by specifying them on the command line extension:
  811.  
  812.           C:\HAM\LOGBOOK LOGBOOK  to access the CWTERM logbook
  813.           C:\HAM\LOGBOOK CONTEST  to access the logbook named CONTEST
  814.  
  815.      8.3  NTS MESSAGE DATA FILE
  816.  
  817.      8.3.1 CWTERM maintains a data base of NTS messages which have been
  818.      transmitted.  These messages are in a DBASE-III compatible file with
  819.      the following data dictionary:
  820.  
  821.           DATA FIELD     TYPE      SIZE
  822.  
  823.           MSG_NBR        C         4
  824.           PRECEDENCE     C         1
  825.           HANDLING       C         1
  826.           HANDL_EXT      C         5
  827.           STATION        C         10
  828.           ORIGIN         C         15
  829.           FILE_TIME      C         4
  830.           FILE_MONTH     C         3
  831.           FILE_DAY       C         2
  832.           ADDRESSEE      C         25
  833.           ADDR1          C         25
  834.           ADDR2          C         25
  835.           CITY           C         25
  836.           STATE          C         2
  837.           ZIP            C         5
  838.           PHONE          C         13
  839.           TEXT_1         C         65
  840.           TEXT_2         C         65
  841.           TEXT_3         C         65
  842.           TEXT_4         C         65
  843.           TEXT_6         C         65
  844.           SIGN           C         25
  845.           SIGN_ADR1      C         25
  846.           SIGN_ADR2      C         25
  847.           SIGN_CITY      C         25
  848.           SIGN_ST        C         2
  849.           SIGN_ZIP       C         5
  850.           SIGN_PHN       C         13
  851.  
  852.      8.3.1  NTS Data Base Access - You access the NTS data base via the Log/NTS
  853.      menu. The transmit/receive screen will be replaced with a data entry form
  854.      which relates directly to the NTS message format.  The last message sent
  855.      (or a blank message for a new data base) will be in the fields.
  856.  
  857.      8.3.2 Data entry and movement through the data base is very similar to
  858.      making log book entries.  The main difference is that prompts and
  859.      selectable data entries are provided.  The casual preparation of an
  860.      NTS message does not require much of a learning curve.  The word count
  861.      is performed automatically.
  862.  
  863.      8.3.3   Data Entry Format:
  864.  
  865.          ┌─┤ 1 of  1 ├──┤HAMGRAM.DBF├─┤04/14/90├───────────────────────────┐
  866.          │ Nbr  P   Handling Inst  OrigSta  Place of Origin  Time Mon Day  │
  867.          ├─────────────────────────────────────────────────────────────────┤
  868.          │            HX                                                   │
  869.          ├─────────────────────────────────────────────────────────────────┤
  870.          │    To:                             Phone #                      │
  871.          │                                                                 │
  872.          │                                                                 │
  873.          │                                                                 │
  874.          ├─────────────────────────────────────────────────────────────────┤
  875.          │                                                                 │
  876.          │                                                                 │
  877.          │                                                                 │
  878.          │                                                                 │
  879.          │                                                                 │
  880.          ├─────────────────────────────────────────────────────────────────┤
  881.          │   From:                            Phone #                      │
  882.          │                                                                 │
  883.          │                                          ┌──────────────────────┤
  884.          │                                          │Word Count :          │
  885.          └──────────────────────────────────────────┴──────────────────────┘
  886.       N)ext P)rev T)op b(O)t G)o S)rch E)dit A)dd D)el B)row Pa(C)k W)rite Q)uit
  887.                                   <F1> for HELP
  888.  
  889.  
  890.      8.3.4  Writing the message to an ASCII file.  Pressing the <W> select
  891.      key will write the message in NTS format to a file name MSGnnnnn where
  892.      nnnnn is the assigned message number in the data entry form.
  893.  
  894.      8.3.5  Return to the transmit receive screen by pressing <Q> for quit.
  895.  
  896.      8.3.6  The file MSGnnnnn may now be sent as a plain text file trans-
  897.      mission.
  898.  
  899.      8.4 COUNTRY
  900.  
  901.      8.4.1 COUNTRY.EXE is a fast retrieval program for locating countries
  902.      when the callsign prefix is known.
  903.  
  904.      8.4.1 The file COUNTRY.LST is an ASCII file with the following format:
  905.  
  906.           ;Prefix Country/State/City      │sDD.MM│sDDD.MM
  907.           ;{Local}Cape May NJ             │ 38.57│  74.50
  908.           A2      BOTSWANA                │-22.00│ -24.00
  909.           A3      TONGA IS                │-20.00│ 175.00
  910.           A4X     OMAN                    │ 22.00│ -58.00
  911.           A5      BHUTAN                  │ 27.30│ -90.06
  912.  
  913.      Comment and special data lines begin with a semicolon.  The program
  914.      will default to computation of distance in nautical miles.  To change
  915.      to another standard delete the appropriate leading semi-colon from
  916.      the appropriate one of the lines which specify statue miles or kilo-
  917.      meters:
  918.  
  919.           ;;{Earth major axis st.miles     │ 3906.5
  920.           ;;{Earth major axis in kilometrs}│ 6387.388
  921.  
  922.      Each line of data must conform to the specified format.
  923.  
  924.           Prefix Country/State/City      │sDD.MM│sDDD.MM
  925.  
  926.      Your own latitude and longitude is specified on the ";local" line as
  927.      shown above.
  928.  
  929.      The entry for Cape May NJ, the authors QTH is:
  930.  
  931.      ;{Local}Cape May NJ             │ 38.57│  74.50
  932.  
  933.      The entry for Cedar Rapids would be:
  934.  
  935.      ;{Local}IOWA, CEDAR RAPIDS      │ 41.58│  91.40
  936.  
  937.      8.4.2  Accessing Prefix/Country list - Select Countries from the
  938.      Accessory pull down menu to call up the COUNTRY.EXE program.  You may
  939.      also access this program from the COMMAND.COM prompt.
  940.  
  941.      8.4.3  Quick location of a prefix can be obtained by pressing the
  942.      first letter of the prefix.
  943.  
  944.      8.4.4 Search by name of country is obtained by pressing CONTROL-S.
  945.      This opens a request window for the search string.  The search string
  946.      is not case sensitive, for example INDIA, india, and India will all
  947.      locate the same entry.  The light bar will be placed on the first
  948.      entry found containing that string, or left in place if not found.
  949.  
  950.      8.4.5 The file can be maintained using a non-document editor.  Be
  951.      certain to observe the limitation of line size and format.  You
  952.      should also maintain the alpha numeric sort of entries.  Adding or
  953.      deleting lines will not effect the program operation.
  954.                                    Chapter 9
  955.  
  956.                             Capturing Incoming Text
  957.  
  958.      9.1  Three methods are available for capturing incoming text.  The
  959.      receive buffer may be saved to a text file as previously described.
  960.      The incoming text may also be sent to a file as it arrives.   This is
  961.      accomplished by pressing alt<C>.  The capture file is always named
  962.      CWTERM.TXT and will be in the default directory.  A separatly named
  963.      file may also be saved by pressing alt<R> or from the Files menu.
  964.  
  965.      9.2 Incoming text will continue to be sent to the file until the next
  966.      alt<C> (or alt<r>) is pressed.  The file will be closed.
  967.                                    Chapter 10
  968.  
  969.                             Modifying Program Defaults
  970.  
  971.      10.1  SCREEN COLORS
  972.  
  973.      10.1.1  Screen colors may be changed and saved to the configuration file
  974.      along with the other pertinent data.
  975.  
  976.      10.1.2  COLOR SELECTION SCREEN   The color selection screen is available
  977.      as a choice on the Parameter Menu.  The function keys are used to change
  978.      the foreground and background colors of each screen area used by CWTERM.
  979.      The colors selected by any one function key will rotate continuously
  980.      through the available choices as the key is pressed.
  981.  
  982.      10.2 TRANSMIT PARAMETERS (Parameter menu items)
  983.  
  984.      10.2.1  WPM Rate
  985.  
  986.      The transmit (and default receive) code speed in WPM is set by using
  987.      the WPM entry or pressing alt<W>.  Either method opens up a dialog
  988.      box showing the current WPM and allowing you to enter a new value.
  989.      Pressing <ESC> or <ENTER> retains the present value.  The range of
  990.      allowable values is 1 to 150 wpm.  Values above 80 should be only be
  991.      used on computers capable of MEDIUM or FAST operation.  Values above
  992.      100 should only be used on computers capable of FAST operation.
  993.  
  994.      10.2.2  Transmit Key Weighting
  995.      The wEight entry opens a dialog box showing the current dash to dot
  996.      ratio (weight).  The default is 3.0.  You may vary the weight from
  997.      2.0 to 4.0 in increments of 0.1.
  998.  
  999.      10.2.3  Transmitter Compensation
  1000.  
  1001.      Many QSK transmitters such as the TS440 will cause the keying waveform
  1002.      to be shortened by the t/r relay.  This shortening is usually on the
  1003.      order of milliseconds and will not be noticable until you transmit at
  1004.      greater than 30 WPM.  The Comp(msec) entry opens a dialog box allowing
  1005.      you to specifiy a fixed compensation interval in milliseconds to correct
  1006.      for these transmitters.  The range of allowable values is -25 to +25
  1007.      milliseconds.  Note that you should not expect a negative compensation
  1008.      which would cause the keydown time to go less than zero.  The following
  1009.      table shows the relationship between WPM and Dot Interval in milli-
  1010.      seconds:
  1011.  
  1012.            WPM  Dot Interval     WPM  Dot Interval     WPM  Dot Interval
  1013.  
  1014.              5   240.0 msec       45   26.7 msec        85   14.1 msec
  1015.             10   120.0 msec       50   24.0 msec        90   13.3 msec
  1016.             15    80.0 msec       55   21.8 msec        95   12.6 msec
  1017.             20    60.0 msec       60   20.0 msec       100   12.0 msec
  1018.             25    48.0 msec       65   18.5 msec       105   11.4 msec
  1019.             30    40.0 msec       70   17.1 msec       110   10.9 msec
  1020.             35    34.3 msec       75   16.0 msec       115   10.4 msec
  1021.             40    30.0 msec       80   15.0 msec       120   10.0 msec
  1022.  
  1023.      10.2.4  Farnsworth Keying
  1024.  
  1025.      The program can correctly increase both the inter-character and inter-
  1026.      word intervals to allow the element rate to be sent faster than the
  1027.      effective WPM rate.  Access to this function is via the Farnsworth entry
  1028.      in this menu.  For instance:  WPM can be set to 20 and Farnsworth to 8.
  1029.      Outgoing text will be at 8 words per minute, but the characters will be
  1030.      sent at the 20 words per minute rate.  An entry of 0 for Farnsworth
  1031.      rate will disable this mode.  The Farnsworth rate is also disabled if
  1032.      the WPM is specified as slower than Farnsworth.
  1033.  
  1034.      10.2.5  Tone Toggle and Tone Frequency
  1035.  
  1036.      The program can produce keying tones on the PC speaker at a desired
  1037.      frequency.  The tones can be toggled ON/OFF via the Tones item, and
  1038.      the frequency dialog box is opened with the 'tone fReq' menu item.
  1039.  
  1040.      10.2.6  Interface Port
  1041.  
  1042.      The program can send and receive CW via one of the following: COM1, COM2,
  1043.      LPT1, or LPT2.  The port is selected via the 't/r Port' menu item.  This
  1044.      will open up a "pick list".  Select the desired port using the arrow keys
  1045.      and press <ENTER>.
  1046.  
  1047.      The port i/o pins are:
  1048.                                                          Default Setting
  1049.           LPT1 or LPT2        pin 11 - CW Input         0 v = keydown
  1050.                               pin 14 - PTT Output       0 v = PTT closed
  1051.                               pin 16 - CW Output        0 v = keydown
  1052.                               pin 18-25  GROUND
  1053.  
  1054.           COM1 or COM2        pin 4  - RTS, CW Output   -12 v = keydown
  1055.                               pin 5  - CTS, CW Input    -12 v = keydown
  1056.                               pin 8  - DCR, PTT Output  -12 v = PTT on
  1057.                               pin 7  - GROUND
  1058.  
  1059.      After selecting the port, three more windows are opened in sequence
  1060.      allowing the setting of keying polarity for the three lines.  Select
  1061.      the voltage level that represents the active state for that line.
  1062.  
  1063.      10.2.7  Load/Save Keyboard map
  1064.  
  1065.      CWTERM maintains an internal set of ASCII (keyboard) to MORSE translation
  1066.      tables.  These tables can be written to a file using the "sAve key map"
  1067.      function.  This file is a plain text file with one entry per line as:
  1068.  
  1069.              hh|Q|--.-
  1070.  
  1071.      where the hh is the hex character code, Q stands for the ASCII letter,
  1072.      the vertical bar is a separator, and --.- represents the MORSE code for
  1073.      that letter.  You may add to or modify this file using the editor.  The
  1074.      new keymap file may then be loaded back into CWTERM.  This keymapping
  1075.      must be done manually each time CWTERM is brought on line,  NO automatic
  1076.      sense and load is provided at this time.
  1077.  
  1078.      If you desire to include additional keys which transmit a space you can
  1079.      specify this substitution in the key map file as:
  1080.  
  1081.              hh|L|SP
  1082.  
  1083.      The SP tells the program that this letter represents a space.  The space
  1084.      bar WILL ALWAYS be set to the inter-word space character.  This provides
  1085.      an alternate keyboard character(s) for the space.
  1086.  
  1087.      10.2.8  View/Load/Save Parameters
  1088.  
  1089.      The Parameter set may be viewed by selecting the View menu item.  They
  1090.      may also be saved into the default file CWTERM.CFG (or another specified
  1091.      file).  Previously saved parameters may be loaded as well.  The program
  1092.      will look for the file CWTERM.CFG on startup and load the parameters
  1093.      found therein.
  1094.  
  1095.                             **** IMPORTANT NOTE ****
  1096.  
  1097.      The CPU parameter may only be set by editing the CWTERM.CFG file.
  1098.      This parameter is used to properly set all of the timing constants and
  1099.      to alter the clock interrupt rate of your computer.  The program has
  1100.      been tested successfully on the following:
  1101.  
  1102.                 CPU type   Clock Speed    CPU Parameter
  1103.  
  1104.                 8088       4 MHz          SLOW
  1105.                 80186      8 MHz          SLOW
  1106.                 80286      12 MHz         MEDIUM
  1107.                 80286      16 MHz         MEDIUM
  1108.                 80386SX    20 MHz         MEDIUM
  1109.                 80386DX    25 MHz         FAST
  1110.                 80386DX    33 MHz         FAST
  1111.                 80486      33 MHz         FAST
  1112.  
  1113.      The default CPU speed is SLOW.  Experiment on your computer by using
  1114.      MEDIUM and then FAST to see if performance is affected.  If you exper-
  1115.      ience sluggish keyboard behavior, especially when transmitting code and
  1116.      using the editor simultaneously, then you should use the SLOW parameter.
  1117.      If you do not plan to transmit at the very high CW speeds then the SLOW
  1118.      parameter is preferred for all CPU's.
  1119.                                    Chapter 11
  1120.  
  1121.                                 DOS Applications
  1122.  
  1123.      11.1  You may temporarily exit CWTERM by selecting Dos from the DosApp
  1124.      menu.  The program will bring up a temporary COMMAND.COM from which
  1125.      you can execute DOS commands or other programs.  You may be constrained
  1126.      by the amount of memory available.  Try checking by using the MEM
  1127.      command.  On a 286 laptop computer with 640 K RAM there is 397 K of
  1128.      memory available at this temporary DOS prompt.  If you specify a
  1129.      different COMSPEC file in your autoexec.bat be certain that it is
  1130.      a full specification including drive and directory.  The program will
  1131.      call up your specified command file if it is found.
  1132.  
  1133.           Return to CWTERM by entering 'EXIT' at the dos prompt.
  1134.  
  1135.      11.2  EDITOR  The editor specified in the CWTERM.DEF file can be
  1136.      invoked with a specified edit file by selecting Editor from the
  1137.      DosApp menu.
  1138.  
  1139.      11.3  PROGRAM TERMINATION - The program can be terminated in two ways -
  1140.      by selecting the eXit line on the DosApp menu, or by pressing the
  1141.      <alt>X key.  In either case you will be required to enter a 'y', or
  1142.      'Y' to confirm the termination.
  1143.  
  1144.                                    Chapter 12
  1145.  
  1146.                                    TNCED Editor
  1147.  
  1148.      TNCED is a full screen editor that is distributed with a Word Star (tm)
  1149.      compatible keyboard interface.  It is capable of editing multiple files
  1150.      with a tiled window for each file.  The total size of all files and
  1151.      temporary buffers cannot exceed the size of available memory.  A 640 K
  1152.      computer under DOS 4.0 can handle a single file of approximately 400,000
  1153.      characters.
  1154.  
  1155.      The program is invoked from the command line as:
  1156.  
  1157.          TNCED file1 (file2 file3 file4 ...)
  1158.  
  1159.      to open and edit multiple files.
  1160.  
  1161.      The program is less than 60K in size and therefore is a convenient
  1162.      editor to use when invoked as a child process from another program.
  1163.      This is the way it is used when called by CWTERM.
  1164.  
  1165.      The program is completely configurable by the install program:
  1166.  
  1167.           TNCEDINST.EXE.
  1168.  
  1169.      Keyboard primary and secondary control sequences can be changed to
  1170.      suit the individual user (emulate NE or QED or any other editor of
  1171.      your choice).  They can be modified for your individual taste.  As
  1172.      distributed the primary control sequences are WordStar (tm) compat-
  1173.      ible.
  1174.  
  1175.      GRAPHICS EDITING
  1176.  
  1177.      The editor can be put into a graphics mode by pressing either <F10>
  1178.      or <alt G>.  You return to the text mode by pressing the same key.
  1179.  
  1180.      The top line of the screen will show the present graphics characters
  1181.      available.  Press <G> a few times to observe the full set of graphics
  1182.      characters available.  Pressing <A> toggles between automatic and manual
  1183.      selection of cursor movement.  When the AUTO is shown on the top line the
  1184.      direction will change each time a corner is inserted into the text.  Nor-
  1185.      mal motion is clock-wise.  You can force the cursor movement to change
  1186.      direction by pressing the <D>.
  1187.  
  1188.      The <SPACE>, cursor keys, HOME, END, PageUp, and PageDn all behave the
  1189.      same as when in a text mode.  The <INSERT> key is disabled and the editor
  1190.      will only perform in a type over mode.
  1191.  
  1192.      You insert graphic characters by the use of the numeric keypad.  For
  1193.      example the following set of graphics corresponds directly to the numeric
  1194.      keypad as:
  1195.  
  1196.               GRAPHICS        KEYPAD
  1197.  
  1198.               ┌   ┬   ┐     7   8   9
  1199.  
  1200.               ├   ┼   ┤     4   5   6
  1201.  
  1202.               └   ┴   ┘     1   2   3
  1203.  
  1204.                ─   │        0   .
  1205.  
  1206.      The distribution copy of TNCED is installed for B&W displays with a
  1207.      standard set of control key sequences.
  1208.  
  1209.      The arrow keys are specified as Lft, Rgt, Up and Dn.
  1210.  
  1211.      The control key is specified by the carat (^).  For example the key
  1212.      sequence control page up would be:
  1213.  
  1214.          <^PgUp>.
  1215.  
  1216.  
  1217.      ┌──────────────────────────────────┬──────────────────┬─────────────────┐
  1218.      │ STANDARD SET - CONTROL FUNCTION  │  PRIMARY         │  SECONDARY      │
  1219.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1220.      │ Character left                   │  <Lft>           │  <^S>           │
  1221.      │ Character right                  │  <Rgt>           │  <^D>           │
  1222.      │ Word left                        │  <^Lft>          │  <^A>           │
  1223.      │ Word right                       │  <^Rgt>          │  <^F>           │
  1224.      │ Line up                          │  <Up>            │  <^E>           │
  1225.      │ Line down                        │  <Dn>            │  <^X>           │
  1226.      │ Scroll up                        │  <^W>            │                 │
  1227.      │ Scroll down                      │  <^Z>            │                 │
  1228.      │ Page down                        │  <PgDn>          │  <^C>           │
  1229.      │ Page up                          │  <PgUp>          │  <^R>           │
  1230.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1231.      │ Top of window                    │  <^PgUp>         │  <^Q><^R>       │
  1232.      │ Bottom of window                 │  <^PgDn>         │  <^Q><^C>       │
  1233.      │ Cursor to left side              │  <Home>          │  <^Q><^S>       │
  1234.      │ Cursor to right side             │  <End>           │  <^Q><^D>       │
  1235.      │ Top of screen                    │  <^Home>         │  <^Q><^E>       │
  1236.      │ Bottom of screen                 │  <^End>          │  <^Q><^X>       │
  1237.      │ Go to line                       │  <^J><^L>        │  <alt N>        │
  1238.      │ Go to column                     │  <^J><^C>        │                 │
  1239.      │ Previous cursor position         │  <^Q><^P>        │                 │
  1240.      └──────────────────────────────────┴──────────────────┴─────────────────┘
  1241.  
  1242.  
  1243.      ┌──────────────────────────────────┬──────────────────┬─────────────────┐
  1244.      │ STANDARD SET - CONTROL FUNCTION  │  PRIMARY         │  SECONDARY      │
  1245.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1246.      │ Abort Command                    │  <^U>            │                 │
  1247.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1248.      │ Undo last deletion               │  <^Q><^U>        │  <alt U>        │
  1249.      │ Restore line                     │  <^Q><^L>        │                 │
  1250.      │ Tab                              │  <^I>            │                 │
  1251.      │ Insert control char              │  <^P> char       │                 │
  1252.      │ New line                         │  <^M>            │                 │
  1253.      │ Insert line                      │  <^N>            │                 │
  1254.      │ Delete current character         │  <Del>           │  <^G>           │
  1255.      │ Delete left character            │  <^H>            │  <^Bks>         │
  1256.      │ Delete right word                │  <^T>            │                 │
  1257.      │ Delete line right                │  <^Q><^Y>        │                 │
  1258.      │ Delete line                      │  <^Y>            │                 │
  1259.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1260.      │ Find pattern                     │  <^Q><^F>        │  <alt F>        │
  1261.      │ Find and replace                 │  <^Q><^A>        │  <alt R>        │
  1262.      │ Find next                        │  <^L>            │                 │
  1263.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1264.      │ Graphics toggle                  │  <F10>           │  <alt G>        │
  1265.      └──────────────────────────────────┴──────────────────┴─────────────────┘
  1266.  
  1267.  
  1268.      ┌──────────────────────────────────┬──────────────────┬─────────────────┐
  1269.      │ STANDARD SET - CONTROL FUNCTION  │  PRIMARY         │  SECONDARY      │
  1270.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1271.      │ Log drive/path                   │  <^J><^D>        │                 │
  1272.      │ Show TNCED version               │  <^J><^V>        │                 │
  1273.      │ Show available memory            │  <^J><^R>        │  <alt M>        │
  1274.      │ Toggle inster mode               │  <^V>            │  <Ins>          │
  1275.      │ Toggle autoindent mode           │  <^Q><^I>        │  <alt I>        │
  1276.      │ Set undo limit                   │  <^J><^U>        │                 │
  1277.      │ Set default extension            │  <^J><^E>        │                 │
  1278.      └──────────────────────────────────┴──────────────────┴─────────────────┘
  1279.  
  1280.      ┌──────────────────────────────────┬──────────────────┬─────────────────┐
  1281.      │ STANDARD SET - CONTROL FUNCTION  │  PRIMARY         │  SECONDARY      │
  1282.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1283.      │ Abandon file                     │  <^K><^Q>        │  <alt Q>        │
  1284.      │ Read file into window            │  <^K><^R>        │                 │
  1285.      │ Save and continue edit           │  <^K><^S>        │                 │
  1286.      │ Save to file                     │  <^K><^N>        │                 │
  1287.      │ Save and exit to DOS             │  <^K><^X>        │  <alt X>        │
  1288.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1289.      │ Add Window                       │  <^O><^A>        │  <alt W><alt W> │
  1290.      │ Resize current window            │  <^O><^S>        │  <alt W><alt S> │
  1291.      │ Next Window                      │  <^O><^N>        │  <alt W><alt N> │
  1292.      │ Previous Window                  │  <^O><^P>        │  <alt W><alt P> │
  1293.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1294.      │ Begin block                      │  <^K><^B>        │  <alt B><alt B> │
  1295.      │ End block                        │  <^K><^K>        │  <alt B><alt E> │
  1296.      │ Top of block                     │  <^Q><^B>        │                 │
  1297.      │ Bottom of block                  │  <^Q><^K>        │                 │
  1298.      │ Copy block                       │  <^K><^C>        │  <alt B><alt C> │
  1299.      │ Move block                       │  <^K><^V>        │  <alt B><alt M> │
  1300.      │ Delete block                     │  <^K><^Y>        │  <alt B><alt D> │
  1301.      │ Toggle (hide) block display      │  <^K><^H>        │  <alt B><alt H> │
  1302.      │ Mark curent word                 │  <^K><^T>        │                 │
  1303.      │ Write block to file              │  <^K><^W>        │                 │
  1304.      └──────────────────────────────────┴──────────────────┴─────────────────┘
  1305.  
  1306.  
  1307.      ┌──────────────────────────────────┬──────────────────┬─────────────────┐
  1308.      │ STANDARD SET - CONTROL FUNCTION  │  PRIMARY         │  SECONDARY      │
  1309.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1310.      │ Set marker 0                     │  <^K>0           │                 │
  1311.      │ Set marker 1                     │  <^K>1           │                 │
  1312.      │ Set marker 2                     │  <^K>2           │                 │
  1313.      │ Set marker 3                     │  <^K>3           │                 │
  1314.      │ Set marker 4                     │  <^K>4           │                 │
  1315.      │ Set marker 5                     │  <^K>5           │                 │
  1316.      │ Set marker 6                     │  <^K>6           │                 │
  1317.      │ Set marker 7                     │  <^K>7           │                 │
  1318.      │ Set marker 8                     │  <^K>8           │                 │
  1319.      │ Set marker 9                     │  <^K>9           │                 │
  1320.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1321.      │ Hide/Unhide marker               │  <^K><^M>        │ <alt B><alt H>  │
  1322.      ├──────────────────────────────────┼──────────────────┼─────────────────┤
  1323.      │ Jump to marker 0                 │  <^Q>0           │                 │
  1324.      │ Jump to marker 1                 │  <^Q>1           │                 │
  1325.      │ Jump to marker 2                 │  <^Q>2           │                 │
  1326.      │ Jump to marker 3                 │  <^Q>3           │                 │
  1327.      │ Jump to marker 4                 │  <^Q>4           │                 │
  1328.      │ Jump to marker 5                 │  <^Q>5           │                 │
  1329.      │ Jump to marker 6                 │  <^Q>6           │                 │
  1330.      │ Jump to marker 7                 │  <^Q>7           │                 │
  1331.      │ Jump to marker 8                 │  <^Q>8           │                 │
  1332.      │ Jump to marker 9                 │  <^Q>9           │                 │
  1333.      └──────────────────────────────────┴──────────────────┴─────────────────┘
  1334.                                    Chapter 13
  1335.  
  1336.                                CODE PRACTICE PARSER
  1337.  
  1338.      13.1  The program, PARSE.EXE, will generate a control/text file suitable
  1339.      for use with CWTERM for automatic code practice sessions.  A feature of
  1340.      MSDOS called indirection is used for specifying the source and output
  1341.      for PARSE.EXE.
  1342.  
  1343.      13.2  Begin by creating an ASCII text file which will be the source used
  1344.      for the code practice session.  W1AW usually transmits its code practice
  1345.      sessions using text for QST.  I prefer to use the Sunday edition of the
  1346.      local paper, as most non-hams have access to this source.  The sports
  1347.      section provides a nice mix of characters, numbers, and punctuation marks.
  1348.      This source should be approximately 50 lines of text with 64 characters
  1349.      per line, or 3200 characters in length.  I suggest you use the editor,
  1350.      TNCED.EXE, to create this file.  If you use Word Perfect, Word Star, or
  1351.      some other word processing program be sure that the file is save as
  1352.      ASCII (or PLAIN) text.
  1353.  
  1354.      13.3  Assuming you have named this file, NEWS, you invoke the parsing
  1355.      processor as:
  1356.  
  1357.           PARSE SCRIPTFILE SOURCEFILE DESTFILE
  1358.  
  1359.      13.1  Two sample script files are included on the distribution disk,
  1360.      SCRIPT.FST and SCRIPT.SLW.  These generate code practice sessions for
  1361.      5, 10 & 13 and 13, 18 & 24 wpm respectively.
  1362.  
  1363.      13.2  The lines containing "%spd nn tt" instruct the parsing program
  1364.      to insert text from the SOURCEFILE at nn WPM for tt minutes transmission
  1365.      time.
  1366.  
  1367.                                    Chapter 14
  1368.  
  1369.                          AUTO CODE PRACTICE TRANSMISSIONS
  1370.  
  1371.      14.1  The program, PRACTICE.EXE, will allow the automatic transmission
  1372.      of a date-stamped file with a name specified as:
  1373.  
  1374.           MM-DD-YY.QST,  where      MM  -  month, 01 - 12,
  1375.                                     DD  -  day, 01 - 31,
  1376.                                     YY  -  year, 00 - 99.
  1377.  
  1378.      14.2  You transmit the code practice of the day by simply running
  1379.      PRACTICE.  The program looks for the date-stamped file and invokes
  1380.      CWTERM with that file specified as the text source.
  1381.  
  1382.      14.3  There are several very good disk manager programs available which
  1383.      allow the operator to specify timed execution of one or more programs.
  1384.      HDM, Hard Disk Manager, is a share ware program with this capability.
  1385.      Combining CWTERM, PARSE, PRACTICE and HDM will allow you to create
  1386.      daily code practice sessions for transmission in your local area.
  1387.  
  1388.                                    APPENDIX
  1389.  
  1390.                      AUTO CODE PRACTICE SAMPLE TRANSMISSION
  1391.  
  1392.    --------------------------- tranmit file begins ------------------------
  1393. |M
  1394. |D1
  1395. |W18
  1396. |F13
  1397. QST DE W1HKJ     QST DE W1HKJ     QST DE W1HKJ
  1398. |D1
  1399. CODE PRACTICE TONIGHT AT 15, 20, 25, AND 30 WPM
  1400. |D1
  1401. TEXT FROM PAGE
  1402. |W18
  1403. |F13
  1404. |D2
  1405. 15 WPM FOLLOWS
  1406. |F15
  1407. |D2
  1408. vvv
  1409. |D2
  1410. VINELAND - BUENA REGIONAL AND VINELAND HIGH SCHOOLS HAD NOT MET ON THE
  1411. FOOTBALL FIELD SINCE 1982.  AFTER SATURDAYS CLASH, IT MAY BE NINE MORE
  1412. YEARS UNTIL ANY TWO TEAMS MATCH THE SHOW THE CHIEFS AND THE CLAN PUT ON
  1413. AT GITTONE MEMORIAL FIELD.  JUST ASK ANY OF THE 2,500-OR-SO FANS WHO
  1414. SAY IT.  VINELAND PREVAILED IN THE THRILLING INTERDIVISIONAL CAPE-ATLANTIC
  1415. LEAGUE GAME 13-11, BUT NOT BEFORE SURVIVING A DAZZLING BUENA RALLY.  THE
  1416. CHIEFS,
  1417. |W18
  1418. |F13
  1419. |D2
  1420. 20 WPM FOLLOWS
  1421. |W20
  1422. |F0
  1423. |D2
  1424. vvv
  1425. |D2
  1426. TRAILING 13-3 MIDWAY THROUGH THE FOURTH QUARTER, SCORED A
  1427. TOUCHDOWN WITH 4:29 LEFT.  THEN THEY GOT REALLY SERIOUS.  WHILE THE CLAN
  1428. WAS RUNNING OUT THE CLOCK (AND FORCING BUENA TO USE UP ALL ITS TIME OUTS)
  1429. IN THE LAST MINUTE, BURLY FULLBACK DEANDRE JONES TOOK A HANDOFF FROM
  1430. QUARTERBACK ART BARUFFI, TOOK A HIT AND FUMBLED THE BALL.  BUENAS ROBERT
  1431. ALLEN GOBBLED IT UP.  FIRST DOWN, BUENA AT THE CLAN 22 - 33 SECONDS TO
  1432. GO.  DRAMATIC, RIGHT?  READ ON.  ON FIRST DOWN, CHIEFS QUARTERBACK DAN
  1433. TORRES MISSED A CONNECTION WITH TOTALLY UNGUARDED END WILFREDO ANDUJAR
  1434. IN THE
  1435. |W18
  1436. |F13
  1437. |D2
  1438. 25 WPM FOLLOWS
  1439. |W25
  1440. |F0
  1441. |D2
  1442. vvv
  1443. |D2
  1444. FLAT.  ON SECOND DOWN, RON ROBERTS SNARED A TORRES HEAVE AFTER IT
  1445. BOUNCED OFF HIS HANDS AND THE HANDS OF TWO DEFENDERS.  FIRST DOWN, BUENA
  1446. AT THE 10-YARD LINE.  WITH 14 SECONDS LEFT, ANOTHER ATTEMPT AT A TORRES-
  1447. ANDUJAR HOOKUP WENT AWRY.  ENTER PLACE-KICKER BRIAN ROVANI - WHO HAD BOOTED
  1448. A 25-YARD FIELD GOAL AT THE END OF THE FIRST HALF - WITH 10 SECONDS TO GO.
  1449.   THE SNAP WAS GOOD, THE BALL SAILED TOWARD THE GOAL POST, AND FADED A
  1450. COUPLE OF FEET WIDE TO THE RIGHT.  GOODBYE, BUENA.  GOOD TRY, BUENA.  FROM
  1451. MY ANGLE IT LOOKED LIKE IT WAS OFF, BUT I HAD MY FINGERS CROSSED, VINELAND
  1452. COACH RON DERUCHIE SAID WITH A SMILE.  WHEN MY GUY (JONES) FUMBLED, OF
  1453. COURSE I WAS WORRIED.  I THOUGHT IT WAS OVER FOR US.  YOU
  1454. |W18
  1455. |F13
  1456. |D2
  1457. 30 WPM FOLLOWS
  1458. |W30
  1459. |F0
  1460. |D2
  1461. vvv
  1462. |D2
  1463. WORRY ANY
  1464. TIME YOU GIVE UP THE BALL.  HE WAS CARRYING PEOPLE ON HIS BACK ALL DAY AND HE
  1465. WAS BREAKING TACKLES ALL DAY, SO WE GAVE HIM THE BALL.  I CANT BLAME HIM.
  1466.   I WISH I HAD 10 MORE ATHLETES LIKE HIM.  VINELAND, KEEPING THE BALL ON
  1467. THE GROUND EXCEPT FOR A 13-YARD HOOKUP BETWEEN BARUFFI AND JONES ON A
  1468. SCREEN PASS, TOOK A 7-0 LEAD IN THE FIRST PERIOD ON A 57-YARD DRIVE.  JONES,
  1469. 5-FOOT-11, 225 POUNDS, ACCOUNTED FOR 20 OF THE RUSHING YARDS IN THE
  1470. POSSISSION, WHICH ENDED WHEN QUICK BACK CARLTON SAVAGE SPRINTED 18 YARDS
  1471. TO THE END ZONE WITH A PITCHOUT.  DONALD BUNTON ADDED THE EXTRA POINT.
  1472.   BUENA, UNABLE TO MOVE THE BALL FOR MOST OF THE HALF, GOT GOING IN THE
  1473. LAST MINUTE BEFORE HALFTIME WITH A HURRY-UP DEFENSE.  ROBERT ALLEN PICKED
  1474. UP 10 YARDS UP THE MIDDLE.  TORRES CONNECTED WITH RUNNING BACK CLIFFORD
  1475. FOSTER FOR 25 YARDS AND WITH ANDUJAR FOR
  1476. |W18
  1477. |F13
  1478. |D4
  1479. THIS ENDS W1HKJ CODE PRACTICE
  1480. |D2
  1481. QST DE W1HKJ $
  1482. |Q
  1483.    --------------------------- tranmit file ends ------------------------
  1484.